home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2001 May / SGI IRIX Base Documentation 2001 May.iso / usr / share / catman / u_man / cat1 / cocostiff.z / cocostiff
Encoding:
Text File  |  2001-04-17  |  7.7 KB  |  199 lines
  1.  
  2.  
  3.  
  4. CCCCOOOOCCCCOOOOSSSSTTTTIIIIFFFFFFFF((((1111))))                         CCCCMMMMSSSS                          CCCCOOOOCCCCOOOOSSSSTTTTIIIIFFFFFFFF((((1111))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      cocostiff - color correct a TIFF stream
  10.  
  11. SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  12.      _cccc_oooo_cccc_oooo_ssss_tttt_iiii_ffff_ffff [ _----_aaaa _s_o_u_r_c_e__p_r_o_f_i_l_e | _----_ssss _s_o_u_r_c_e__p_r_o_f_i_l_e ] _----_dddd _d_e_s_t_i_n_a_t_i_o_n__p_r_o_f_i_l_e
  13.                [ _----_hhhh ] [ _----_oooo _o_u_t_p_u_t__f_i_l_e ] [ _i_n_p_u_t__f_i_l_e ]
  14.  
  15. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  16.      _c_o_c_o_s_t_i_f_f uses the International Color Consortium (ICC) profiles to
  17.      determine how to perform the appropriate color management operation
  18.      ("color correction", hence "coco") upon a TIFF stream. The operation will
  19.      be a color space conversion from the input device color space to the
  20.      output device color space.
  21.  
  22.      A TIFF stream is a TIFF image file in the Streamable TIFF (STIFF) format.
  23.      STIFF files are directly created by Impressario products, such as _gggg_ssss_cccc_aaaa_nnnn.
  24.      Regular TIFF image files can by turned into STIFF files by running
  25.      _////_uuuu_ssss_rrrr_////_llll_iiii_bbbb_////_pppp_rrrr_iiii_nnnn_tttt_////_iiii_llll_2222_ssss_tttt_iiii_ffff_ffff.
  26.  
  27.      The device color space associated with the input stream is determined in
  28.      one of four ways. The following approaches are tried in order:
  29.  
  30.      +o    First, if the _----_ssss flag is set, the specified _s_r_c-_p_r_o_f_i_l_e will be
  31.           used.  Specifying _----_ssss will override any profile embedded in the
  32.           source image.
  33.  
  34.      +o    Second, if there is an ICC profile embedded in the source image,
  35.           that will be used.
  36.  
  37.      +o    Third, if the _----_aaaa flag is set, the specified _s_r_c__p_r_o_f_i_l_e will be
  38.           used.  Embedded profiles take precedence over profiles specified
  39.           with _----_aaaa.
  40.  
  41.      +o    Finally, the color management system's default monitor or CMYK
  42.           profile will be used.  Which profile, monitor or CMYK, is selected
  43.           will be determined by the number of color channels in the input
  44.           image.  If there are three channels, the monitor profile,
  45.           _mmmm_oooo_nnnn_iiii_tttt_oooo_rrrr_...._pppp_ffff, is selected; if there are four, the CMYK profile,
  46.           _gggg_eeee_nnnn_cccc_mmmm_yyyy_kkkk_...._pppp_ffff.
  47.  
  48.      If no default is set, the system searches through _CCCC_MMMM_SSSS______PPPP_RRRR_OOOO_FFFF_IIII_LLLL_EEEE______PPPP_AAAA_TTTT_HHHH for
  49.      the default monitor profile, _mmmm_oooo_nnnn_iiii_tttt_oooo_rrrr_...._pppp_ffff.  If that profile is not found,
  50.      _cccc_oooo_cccc_oooo_ssss_tttt_iiii_ffff_ffff has no way to determine a source device profile and so passes
  51.      the input image stream through unchanged.
  52.  
  53.      The output device color space is determined quite simply from the value
  54.      of the _----_dddd flag.
  55.  
  56.      If a full path is not provided for a device profile, the system looks
  57.      through the directories specified in _CCCC_MMMM_SSSS______PPPP_RRRR_OOOO_FFFF_IIII_LLLL_EEEE______PPPP_AAAA_TTTT_HHHH.
  58.  
  59.  
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. CCCCOOOOCCCCOOOOSSSSTTTTIIIIFFFFFFFF((((1111))))                         CCCCMMMMSSSS                          CCCCOOOOCCCCOOOOSSSSTTTTIIIIFFFFFFFF((((1111))))
  71.  
  72.  
  73.  
  74.      If, for any reason _cccc_oooo_cccc_oooo_ssss_tttt_iiii_ffff_ffff is unable to perform the requested
  75.      conversion, the source stream is copied to the destination stream.  Some
  76.      of the reasons that a conversion might not be performed are:
  77.  
  78.      +o    no destination profile was specified;
  79.  
  80.      +o    the number of channels in the input or output stream does not match
  81.           its profile;
  82.  
  83.      +o    one of the specified profiles could not be found;
  84.  
  85.      +o    one of the specified profiles could not be read;
  86.  
  87.      +o    the source image is one bit deep;
  88.  
  89.      +o    the CMS did not know how to handle one of the profiles;
  90.  
  91.      +o    the CMS needed to read the system RGB or system CMYK profile and
  92.           could not.
  93.  
  94. CCCCoooommmmmmmmaaaannnndddd LLLLiiiinnnneeee OOOOppppttttiiiioooonnnnssss
  95.      _c_o_c_o_s_t_i_f_f supports the following command line options:
  96.  
  97.      _----_aaaa _s_o_u_r_c_e__p_r_o_f_i_l_e
  98.                Specifies a profile to be used with images that do not have an
  99.                embedded ICC profile.
  100.  
  101.      _----_dddd _d_e_s_t_i_n_a_t_i_o_n__p_r_o_f_i_l_e
  102.                Specifies a profile for the destination device. The destination
  103.                image file format, including the depth and number of channels,
  104.                will be determined by this profile.  _----_hhhh Display a usage
  105.                message.
  106.  
  107.      _----_oooo _o_u_t_p_u_t__f_i_l_e
  108.                The output TIFF file. If this is not supplied, _cccc_oooo_cccc_oooo_ssss_tttt_iiii_ffff_ffff will
  109.                write to standard out.
  110.  
  111.      _----_ssss _s_o_u_r_c_e__p_r_o_f_i_l_e
  112.                The profile for the source device.  This will override any
  113.                profile embedded in the image.  If this profile does not match
  114.                up with the source stream/source file image file format,
  115.                _cccc_oooo_cccc_oooo_ssss_tttt_iiii_ffff_ffff will pass the source through unchanged.
  116.  
  117.      _i_n_p_u_t__f_i_l_e
  118.                The input TIFF file.  If this is not supplied, _cccc_oooo_cccc_oooo_ssss_tttt_iiii_ffff_ffff will
  119.                read from standard in.
  120.  
  121.  
  122. EEEERRRRRRRROOOORRRRSSSS
  123.      Because _cccc_oooo_cccc_oooo_ssss_tttt_iiii_ffff_ffff is a filter, it tries to produce valid output if at all
  124.      possible.  However, there are conditions under which _cccc_oooo_cccc_oooo_ssss_tttt_iiii_ffff_ffff will exit
  125.      with an error condition. These are:
  126.  
  127.  
  128.  
  129.                                                                         PPPPaaaaggggeeee 2222
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136. CCCCOOOOCCCCOOOOSSSSTTTTIIIIFFFFFFFF((((1111))))                         CCCCMMMMSSSS                          CCCCOOOOCCCCOOOOSSSSTTTTIIIIFFFFFFFF((((1111))))
  137.  
  138.  
  139.  
  140.      +o    a source file was specified, but could not be opened;
  141.  
  142.      +o    a destination file was specified, but could not be opened;
  143.  
  144.      +o    an unrecoverable system error.
  145.  
  146. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  147.      _v_s_t_i_f_f(1), _l_i_b_s_t_i_f_f(3).
  148.  
  149.  
  150.  
  151.  
  152.  
  153.  
  154.  
  155.  
  156.  
  157.  
  158.  
  159.  
  160.  
  161.  
  162.  
  163.  
  164.  
  165.  
  166.  
  167.  
  168.  
  169.  
  170.  
  171.  
  172.  
  173.  
  174.  
  175.  
  176.  
  177.  
  178.  
  179.  
  180.  
  181.  
  182.  
  183.  
  184.  
  185.  
  186.  
  187.  
  188.  
  189.  
  190.  
  191.  
  192.  
  193.  
  194.  
  195.                                                                         PPPPaaaaggggeeee 3333
  196.  
  197.  
  198.  
  199.